home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / relnotes / dmedia_eoe / ch16.z / ch16
Text File  |  2001-04-17  |  15KB  |  463 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        16.  _D_i_g_i_t_a_l__M_e_d_i_a__C_o_m_m_a_n_d_s
  9.  
  10.        The digital media subsystem _d_m_e_d_i_a__e_o_e._s_w._b_a_s_e contains a
  11.        number of command line utility programs.  This chapter
  12.        describes changes, additions, and bug fixes to these
  13.        commands.
  14.  
  15.  
  16.        16.1  _D_i_g_i_t_a_l__M_e_d_i_a__F_i_l_e__C_o_n_v_e_r_s_i_o_n__C_o_m_m_a_n_d_s
  17.  
  18.  
  19.  
  20.        The following digital media file conversion and information
  21.        utilities are included in _d_m_e_d_i_a__e_o_e._s_w._b_a_s_e:
  22.  
  23.           +o _d_m_i_n_f_o(1)               display info about sound,
  24.             movie, image files
  25.  
  26.           +o _d_m_c_o_n_v_e_r_t(1)    general purpose sound, image, movie
  27.             converter tool
  28.  
  29.           +o _s_f_i_n_f_o(1)         display info about sound files (link
  30.             to _d_m_i_n_f_o)
  31.  
  32.           +o _a_i_f_c_r_e_s_a_m_p_l_e(1)   sampling rate converter (link to
  33.             _d_m_c_o_n_v_e_r_t)
  34.  
  35.           +o _a_i_f_f_2_a_i_f_c(1)      convert AIFF to AIFF-C (link to
  36.             _d_m_c_o_n_v_e_r_t)
  37.  
  38.           +o _a_i_f_c_2_a_i_f_f(1)      convert AIFF-C to AIFF (link to
  39.             _d_m_c_o_n_v_e_r_t)
  40.  
  41.           +o _a_i_f_c_c_o_m_p_r_e_s_s(1)   compress AIFF(-C) data (link to
  42.             _d_m_c_o_n_v_e_r_t)
  43.  
  44.           +o _a_i_f_c_d_e_c_o_m_p_r_e_s_s(1) decompress AIFF(-C) data (link to
  45.             _d_m_c_o_n_v_e_r_t)
  46.  
  47.           +o _s_f_c_o_n_v_e_r_t(1)      sound file converter (link to
  48.             _d_m_c_o_n_v_e_r_t)
  49.  
  50.           +o _m_a_k_e_m_o_v_i_e(1)    movie file converter (link to
  51.             _d_m_c_o_n_v_e_r_t)
  52.  
  53.  
  54.        _d_m_c_o_n_v_e_r_t is a general-purpose command-line tool for
  55.        converting between a variety of digital media file formats.
  56.        It can be used to convert between different movie file
  57.        formats (e.g. SGI movie, QuickTime, MPEG-1 systems
  58.        bitstream, MPEG-1 video bitstream), different sound file
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        formats (e.g. AIFF, AIFF-C, MPEG-1 audio bitstream), and
  75.        sequences of images in various formats (e.g. SGI image,
  76.        JFIF, TIFF, GIF, FIT).
  77.  
  78.        _d_m_i_n_f_o is a command-line utility program which displays
  79.        detailed information about the audio and/or image tracks in
  80.        a digital media file (sound file, movie file, or image
  81.        file). The tool also displays general information such as
  82.        the total playing time for the file.
  83.  
  84.  
  85.  
  86.        16.1.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s__s_i_n_c_e__I_R_I_X__5_._3
  87.  
  88.           +o _d_m_c_o_n_v_e_r_t(_1) is a new general-purpose digital media
  89.             file conversion utility which replaces _a_i_f_c_2_a_i_f_f(_1),
  90.             _a_i_f_f_2_a_i_f_c(_1), _a_i_f_c_c_o_m_p_r_e_s_s(_1), _a_i_f_c_d_e_c_o_m_p_r_e_s_s(_1),
  91.             _a_i_f_c_r_e_s_a_m_p_l_e(_1), _s_f_c_o_n_v_e_r_t(_1), and _m_a_k_e_m_o_v_i_e(_1).  The
  92.             older programs are still available for backwards
  93.             compatibility.
  94.  
  95.           +o _d_m_i_n_f_o(_1) is a new utility program which displays
  96.             various attributes of the audio and/or image data
  97.             stored in a digital media file.  It replaces
  98.             _a_i_f_c_i_n_f_o(_1), _s_f_i_n_f_o(_1), and _m_a_k_e_m_o_v_i_e -_D.  The older
  99.             programs are still available for backwards
  100.             compatibility.
  101.  
  102.  
  103.        16.1.2  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s  This section lists
  104.        changes/additions to the digital media conversion commands
  105.        between the IRIX 6.2 and IRIX 6.3/6.4 releases.
  106.  
  107.           +o _d_m_c_o_n_v_e_r_t includes the ability to convert to the AVI
  108.             movie format.
  109.  
  110.           +o _d_m_c_o_n_v_e_r_t includes support for the Intel Indeo 3.2
  111.             compressor.
  112.  
  113.           +o _d_m_c_o_n_v_e_r_t no longer requires an SGI license to enable
  114.             MPEG-1 audio, MPEG-1 video, or Cinepak encoding. These
  115.             capabilities are now bundled with the base IRIX 6.3 and
  116.             6.4 software releases.
  117.  
  118.           +o _d_m_c_o_n_v_e_r_t includes support for additional sound file
  119.             formats: Creative Labs SoundFont 2, SampleVision,
  120.             Creative Labs VOC, Audio Visual Research, Amiga
  121.             IFF/8SVX.
  122.  
  123.           +o _d_m_c_o_n_v_e_r_t includes support for several additional audio
  124.             compression schemes: CCITT G.726, CCITT G.728, GSM
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.             06.10, IMA DVI ADPCM.
  141.  
  142.  
  143.  
  144.        16.2  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  145.  
  146.           +o _d_m_c_o_n_v_e_r_t does not yet handle transfer of inst chunk
  147.             information for any formats other than AIFF and AIFF-C.
  148.             Similarly, many miscellaneous chunk types are not
  149.             transferred between all available file types.  _d_m_i_n_f_o
  150.             also fails to parse much of this information in the
  151.             other file formats.  There is sample code in
  152.             /_u_s_r/_s_h_a_r_e/_s_r_c/_d_m_e_d_i_a/_s_o_u_n_d_c_o_m_m_a_n_d_s showing methods of
  153.             doing these things.
  154.  
  155.  
  156.  
  157.  
  158.        16.3  _A_u_d_i_o__R_e_c_o_r_d_i_n_g__a_n_d__P_l_a_y_b_a_c_k__C_o_m_m_a_n_d_s
  159.  
  160.  
  161.  
  162.        The following sound utility commands are included in
  163.        _d_m_e_d_i_a__e_o_e._s_w._b_a_s_e:
  164.  
  165.  
  166.           +o _s_f_p_l_a_y(1)         sound file playback command
  167.  
  168.           +o _p_l_a_y_a_i_f_c(1)       installed as a symbolic link to
  169.             _s_f_p_l_a_y
  170.  
  171.           +o _p_l_a_y_a_i_f_f(1)       installed as a symbolic link to
  172.             _s_f_p_l_a_y
  173.  
  174.           +o _s_f_r_e_c_o_r_d(1)       sound file recording command
  175.  
  176.           +o _r_e_c_o_r_d_a_i_f_c(1)     installed as a symbolic link to
  177.             _s_f_r_e_c_o_r_d
  178.  
  179.           +o _r_e_c_o_r_d_a_i_f_f(1)     installed as a symbolic link to
  180.             _s_f_r_e_c_o_r_d
  181.  
  182.           +o _p_a_s_s_t_h_r_u(1)       user-level audio in to audio out
  183.             utility
  184.  
  185.  
  186.        The IRIS Digital Media Development Environment 6.4 (shipped
  187.        as part of IRIS Development Option 6.4) includes complete
  188.        source code for all of the above commands.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        16.3.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s  This section lists
  207.        changes/additions to the sound commands between the IRIX 6.2
  208.        and IRIX 6.3/6.4 releases.
  209.  
  210.           +o _s_f_r_e_c_o_r_d is a new general-purpose command-line tool for
  211.             recording sound files. The older _p_l_a_y_a_i_f_c and _p_l_a_y_a_i_f_f
  212.             invocations are retained for backward compatibility.
  213.             _s_f_r_e_c_o_r_d supports a number of output formats: WAVE,
  214.             Sun/NeXT, raw sample data, and the CCITT G.726, CCITT
  215.             G.728, GSM, MPEG-1 audio, and DVI ADPCM codecs.
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.        16.4  _V_i_d_e_o__U_t_i_l_i_t_y__C_o_m_m_a_n_d_s
  223.  
  224.  
  225.  
  226.        The following video I/O utility commands are included in
  227.        _d_m_e_d_i_a__e_o_e._s_w._b_a_s_e:
  228.  
  229.  
  230.           +o _v_i_d_e_o_i_n(1)        display video input in a window
  231.  
  232.           +o _v_i_d_e_o_o_u_t(1)       send a portion of the screen to video
  233.             out
  234.  
  235.           +o _v_i_d_t_o_m_e_m(1)       single video frame capture to memory
  236.  
  237.           +o _m_e_m_t_o_v_i_d(1)       single video frame output from memory
  238.  
  239.           +o _v_i_n_t_o_v_o_u_t(1)      user-level video in to video out
  240.             utility
  241.  
  242.           +o _v_l_i_n_f_o_f_P(_1)             _d_i_s_p_l_a_y _V_i_d_e_o _L_i_b_r_a_r_y
  243.             _c_o_n_f_i_g_u_r_a_t_i_o_n _i_n_f_o_r_m_a_t_i_o_n
  244.  
  245.  
  246.        _T_h_e _I_R_I_S _D_i_g_i_t_a_l _M_e_d_i_a _D_e_v_e_l_o_p_m_e_n_t _E_n_v_i_r_o_n_m_e_n_t _6._4 (_s_h_i_p_p_e_d
  247.        _a_s _p_a_r_t _o_f _I_R_I_S _D_e_v_e_l_o_p_m_e_n_t _O_p_t_i_o_n _6._4) _i_n_c_l_u_d_e_s _c_o_m_p_l_e_t_e
  248.        _s_o_u_r_c_e _c_o_d_e _f_o_r _a_l_l _o_f _t_h_e _a_b_o_v_e _v_i_d_e_o _u_t_i_l_i_t_y _c_o_m_m_a_n_d_s.
  249.  
  250.  
  251.        _1_6._4._1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s  This section lists
  252.        changes/additions to the video commands between the IRIX 6.2
  253.        and IRIX 6.3/6.4 releases.
  254.  
  255.           +o Each of the above video commands is supported on the
  256.             built-in video I/O subsystem for video-equipped O2
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.             workstations.
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.        16.5  _V_i_d_e_o__D_i_s_k__R_e_c_o_r_d_i_n_g__a_n_d__P_l_a_y_b_a_c_k__C_o_m_m_a_n_d_s
  281.  
  282.  
  283.  
  284.        The following audio/video disk recording and playback
  285.        commands are included in _d_m_e_d_i_a__e_o_e._s_w._b_a_s_e:
  286.  
  287.  
  288.           +o _d_m_r_e_c_o_r_d(1)       record motion JPEG video with audio
  289.             to disk
  290.  
  291.           +o _d_m_p_l_a_y(1)          play back motion JPEG video with
  292.             audio from disk
  293.  
  294.  
  295.        _d_m_r_e_c_o_r_d is a command-line tool for hard disk video
  296.        recording.  It records an SGI movie file which contains a
  297.        JPEG-compressed video track and, optionally, a synchronized
  298.        audio track. _d_m_r_e_c_o_r_d supports real-time video recording to
  299.        disk through ev1 video (Galileo Video, Indigo2 Video, Indy
  300.        Video) and the Cosmo Compress JPEG video compressor.
  301.        Starting with IRIX 6.3, _d_m_r_e_c_o_r_d also supports real-time
  302.        recording to disk using the built-in audio/video input ports
  303.        and built-in realtime JPEG encoding capabilities of the O2
  304.        workstation. By default it produces QuickTime movies using a
  305.        new format, which is not playable using the previous version
  306.        of dmplay. It can however be instructed to produce SGI
  307.        movies in the old format.
  308.  
  309.        Starting with IRIX 6.3 for O2 R10000, _d_m_r_e_c_o_r_d can also
  310.        produce movies by capturing the images on the monitor
  311.        screen.
  312.  
  313.        _d_m_p_l_a_y is a command-line tool for hard disk video playback.
  314.        It plays back an SGI movie file which contains a JPEG-
  315.        compressed image track. By default, _d_m_p_l_a_y uses the Cosmo
  316.        Compressor JPEG decompressor to decode the image track in
  317.        real-time. The decompressed video output from Cosmo is
  318.        passed through the ev1 video device and is displayed in a
  319.        video window on the screen. _d_m_p_l_a_y supports synchronized
  320.        audio playback when video is decompressed using Cosmo.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.        Starting with IRIX 6.3, _d_m_p_l_a_y also supports real-time
  339.        playback from disk using the built-in audio/video output
  340.        ports and built-in realtime JPEG decoding capabilities of
  341.        the O2 workstation. The O2 memory-based architecture allows
  342.        decompressed video to be passed directly to the graphics
  343.        framebuffer in main memory for display to the screen, either
  344.        by itself or simultaneously with display to video. This
  345.        version of dmplay can play both SGI movies of the old format
  346.        and the QuickTime movies of the new format.
  347.  
  348.        _d_m_p_l_a_y also supports playback in a graphics window using
  349.        software JPEG decompression. In this mode, video playback is
  350.        non-real-time, and audio playback is not supported.
  351.  
  352.        The IRIS Digital Media Development Environment 6.4 (shipped
  353.        as part of IRIS Development Option 6.4) includes complete
  354.        source code for _d_m_p_l_a_y and _d_m_r_e_c_o_r_d.
  355.  
  356.  
  357.  
  358.        16.5.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s  This section lists
  359.        changes/additions to the digital media recording and
  360.        playback commands between the IRIX 6.2 and IRIX 6.3/6.4
  361.        releases.
  362.  
  363.           +o _d_m_r_e_c_o_r_d now supports synchronized audio/video capture
  364.             on video-equipped O2 workstations using the built-in
  365.             memory-to-memory realtime JPEG encoding capability of
  366.             the system.
  367.  
  368.           +o _d_m_p_l_a_y now supports synchronized audio/video playback
  369.             on the O2 workstation with display to screen and or
  370.             video out using the built-in memory-to-memory realtime
  371.             JPEG decoding capability of the system. (Display to
  372.             video out is only available on video-equipped systems.)
  373.  
  374.  
  375.        16.5.2  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s  This section lists
  376.        changes/additions to the digital media recording and
  377.        playback commands between the IRIX 6.3 and IRIX 6.3 for O2
  378.        R10000 releases.
  379.  
  380.           +o _d_m_r_e_c_o_r_d now can produce JPEG movies by capturing
  381.             screen images.
  382.  
  383.  
  384.  
  385.  
  386.        16.5.3  _B_u_g__F_i_x_e_s
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                   - 7 -
  401.  
  402.  
  403.  
  404.           +o _d_m_p_l_a_y now performs the zzzzoooooooommmm option correctly.
  405.  
  406.           +o The performance of _d_m_p_l_a_y is much improved for both
  407.             graphics and video display.
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.        16.6  _S_y_n_c_h_r_o_n_i_z_e_d _A_u_d_i_o/_V_i_d_e_o _R_e_a_l_t_i_m_e _U_n_c_o_m_p_r_e_s_s_e_d _D_i_s_k
  415.              _R_e_c_o_r_d_i_n_g _a_n_d _P_l_a_y_b_a_c_k _C_o_m_m_a_n_d_s
  416.  
  417.  
  418.  
  419.        The following synchronized audio/video uncompressed realtime
  420.        disk recording and playback commands are included in
  421.        _d_m_e_d_i_a__e_o_e._s_w._t_o_o_l_s:
  422.  
  423.  
  424.           +o _a_v_c_a_p_t_u_r_e(1)      realtime capture command
  425.  
  426.           +o _a_v_p_l_a_y_b_a_c_k(1)     realtime playback command
  427.  
  428.  
  429.        The IRIS Digital Media Development Environment 6.5 (shipped
  430.        as part of IRIS Development Option 6.5) includes complete
  431.        source code for all of the above commands.
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.